home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir25 / mmconv17.zip / MMSORT.DOC < prev    next >
Text File  |  1993-11-24  |  8KB  |  192 lines
  1.  
  2.          MMSORT
  3.  
  4.  
  5.     MMSORT is intended for people who have multiple MealMaster databases.
  6. It allows efficiency in entering recipes to the appropriate database
  7. initially without manual sorting.   If combined with MMDRIVER which runs
  8. from archived MealMaster files, running multiple databases can become
  9. relatively convenient and storage efficient as well.  (Also useful with
  10. MMMENU, too.)
  11.  
  12.     MMSORT gives you the following display when run without parameters:
  13.  
  14.     Version 1.20 Meal-Master recipe sorter by Rodney Grantham
  15.        770 Cranberry Trail      Roswell, GA 30076
  16.  
  17.          Usage: MMSORT infile [prmfile][ -t]
  18.  
  19.  infile - contains MM format recipes to be processed
  20.  prmfile- contains sorting categories -default is MMSORT.PRM
  21.   -t    - turns off title and file written to display
  22.  Sorting control information must be set up in a file- default: MMSORT.PRM.
  23.  Each of up to 12 lines contains a list of associated categories.
  24.     The first category on a line will determine the filename.
  25.     Recipes with no matching categories go to SORTmmdd.srt.
  26.  
  27.  
  28.  CONFIG.SYS must have FILES=  set high enough.
  29.  
  30.  
  31.  -----------------------------------------------------------------
  32.  
  33.     Basically, you just provide a file of MealMaster format recipes as the
  34. input to MMSORT.  The default file MMSORT.PRM can be used in sorting these
  35. recipes.  You can either modify it or define a totally new file to control
  36. processing.  If it is missing,  MMSORT will inform you.
  37.  
  38.     I use MMSORT.PRM for initial sorting.  Then I use MMSORT2.PRM which is
  39. designed to split MAINDISH.IN into various categories of meats.  The last
  40. category is similar to the MAINDISH line in MMSORT.PRM but starts with
  41. ENTREES.  After I sort with this file, I delete MAINDISH.IN.
  42.  
  43.     The first name on a line in MMSORT.PRM or other file name is used to
  44. create a file name and the file is opened.  If a file name duplicates a
  45. former one, that line will be skipped.  The file name will be qualified
  46. with .IN.  If it already exists, the program appends to it.  At the end of
  47. the run files that had data added to them are displayed with number of
  48. recipes and number of lines written.  Since MM exports with an extra space
  49. between recipes, the number of lines totals will not match.  Number of
  50. recipes should match.
  51.  
  52.  
  53.     Sample run:
  54.  
  55.  
  56. MMSORT mm.out
  57.  
  58.  
  59.  
  60.  Processing: mm.out
  61.  
  62.  
  63.  Processed: mm.out
  64.  Recipes saved: 1725
  65.   Lines read: 57168
  66.  
  67.     1056 recipes (   37063 lines) written to   SORT0914.3 from mm.out
  68.       16 recipes (     466 lines) written to  CROCKPOT.IN from mm.out
  69.       64 recipes (    2334 lines) written to     SOUPS.IN from mm.out
  70.        1 recipes (      24 lines) written to      DOGS.IN from mm.out
  71.       19 recipes (     639 lines) written to    PASTAS.IN from mm.out
  72.      131 recipes (    4449 lines) written to  APPETIZE.IN from mm.out
  73.      204 recipes (    6013 lines) written to  PRESERVE.IN from mm.out
  74.      211 recipes (    3743 lines) written to  BEVERAGE.IN from mm.out
  75.       23 recipes (     672 lines) written to      MISC.IN from mm.out
  76.  
  77.    The matching process is not perfect.  For example the category "Rock
  78. Spring" in one recipe put the recipe in Crockpot.  'ROCK' matched with
  79. 'ROCK' in cROCKpot.  I also kept ending up with ICE CREAM in BREADS.IN
  80. until I dropped CREAMPUFF from the bread line.  TRY IT ends up with
  81. CHICKENS.IN because of POULTRY.  I still think it beats totally sorting by
  82. hand.
  83.  
  84.     If you were to put CHICKEN on the first line, then an APPETIZER with
  85. CHICKEN in the category line would end up in the first line group rather
  86. than the later APPETIZER category it also matched.  So ordering of category
  87. lines can affect your outcome.
  88.  
  89.     (In version 1.20 all the categories are checked against the lines of
  90. categories.  The recipe goes into the match that is first in the file.
  91. Version 1.10 did not do this correctly.)
  92.  
  93.     In setting up MMSORT.PRM, use plurals for category names.  This will
  94. match with either singular or plural categories.  It is not necessary to
  95. have both DESSERT and DESSERTS - DESSERTS will catch both.  Case is
  96. irrelevant.  MMSORT will upper case everything for matching purposes.
  97.  
  98.     Up to 220 characters are read in for a category line.  But you can make
  99. several smaller lines for what will end up as one file and you will
  100. then have several input files to load.  However, only 25 category lines are
  101. supported.
  102.  
  103.     Files are opened 'append'.  Repeated runs will continue to add to the
  104. same files unless they are purged or renamed.  This is unlike the behavior
  105. of most of my programs.  The SORTmmdd.n is handled as usual with successive
  106. versions being numbered.  This supports the usage described below.
  107.  
  108.     If you have a lot of category lines, lots of files are opened
  109. simultaneously.  This may require changing your CONFIG.SYS FILES= statement
  110. to support the additional files needed.  Alternatively, you can sort the MM
  111. recipes in successive passes.  Each time you would use the SORTmmdd.n file
  112. from the prior run as input to the next.
  113.  
  114.     If you normally run with archived recipe databases, you may find that
  115. exporting a large database and processing it severely impacts your storage.
  116. In testing, I finally realized some of the errors I was encountering were
  117. because I was down to zero available storage.
  118.  
  119.     If there are too many files for the parameters set in \CONFIG.SYS or
  120. you are out of storage, you will receive the following message on the file
  121. that exceeds the limit:
  122.  
  123. MMSORT mm.out
  124.  
  125.  Processing: mm.out
  126.  
  127.  SORT0914.1 - couldn't open  Error 0
  128.  Possibly exceeding maximum permitted files.
  129.  Also possible that your storage is exhausted.
  130.  
  131.     It appears that 12 is the maximum number of files any MMSORT.PRM file
  132. can contain and work.  Borland C has a 20 files maximum and 5 are for
  133. system files of various sorts:  screen input & output, error output.  One
  134. is the input file and one is for the SORTmmdd.n file.  There appear to be
  135. one file missing which I can't account for.
  136.  
  137. Sample MMSORT.PRM (the indented items are continuations of the line above-
  138.     I split them here for convenience in reading):
  139.  
  140.  
  141. crockpot
  142. soups chowders stews gumbos chilis
  143. dogs
  144. pastas
  145. appetizers snacks munchies dips cheese treats sandwiches
  146. maindish pork fishes seafood beef chickens meats poultry sausages entrees
  147.    lamb shrimps stews salmon smoker ducks meatloafs hamburgers steaks
  148.    rabbits game pizzas turkey veal scallops
  149. desserts pies cakes candies candy cookies frosting icing ices sherbets
  150.    bars chocolates brownies fudges cheesecakes fruitcakes mousse cobbler
  151.    puddings
  152. breads bisquick breakfast pastry pastries tarts quiche rolls buns biscuits
  153.    pancakes breadmaker sourdough muffins waffles creampuff crepes
  154.    crackers gingerbread batters
  155. vegetables vegan salads soups stuffing dressing side dishes
  156.    vegetarian eggplant veggies fruits beets cabbage  beans side-dish
  157.    rice cheese/eggs casseroles potatoes tomatoes sidedish
  158. preserves jams jellies jelly relishes pickles sauces preserving
  159.    spreads canning pickled mustards salsas condiments chutneys
  160.    seasonings marmalades perserves spreads marinades gravy gravies
  161. beverages drinks alcohol punches ales
  162. misc kids miscellaneous substitutes spices jokes
  163.  
  164. MMSORT2.PRM:
  165.  
  166. chickens poultry turkey
  167. beef sausages hamburgers steaks meatloafs hamburgers
  168. meats pork lamb ducks rabbits game veal calf liver
  169. seafoods fishes shrimps scallops salmon
  170. entrees maindish smoker pizzas casseroles
  171.  
  172.  
  173.     MMSORT should be packaged with MMCONV, MARKIT and MSGSPLIT.  Or with
  174. MMDRIVER.
  175.  
  176.  
  177.     Like MARKIT and MSGSPLIT, it is essentially a free inclusion.  If you
  178. benefit from it, register MMCONV and/or MMDRIVER.  If the utilities are
  179. particularly useful and you would like to encourage additional ones,
  180. include a little extra with your registration.
  181.  
  182.     If you have suggestions for utilities that might be useful send them to
  183. me as well.  I get I-LINK, RIME and FIDO cooking conferences so a message
  184. there works, too.
  185.  
  186.  
  187.             Rodney Grantham
  188.             770 Cranberry Trail
  189.             Roswell, GA 30076
  190.  
  191.  
  192.